Resource URL: /platform/<<version=5>>/cluster/nodes/<LNN>/driveconfig

    Overview: This resource applies the standard collection pattern to
              individual nodes.  LNN in the resource path is the node lnn ID.

     Methods: GET, PUT

********************************************************************************

Method GET: View a node's drive subsystem XML configuration file.

       URL: GET /platform/<<version=5>>/cluster/nodes/<LNN>/driveconfig

Query arguments:
timeout=<number> Request timeout

GET response body schema:
{
  "type": [
    {
      "additionalProperties": false, 
      "type": "object", 
      "description": "A list of errors that may be returned.", 
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false, 
            "type": "object", 
            "description": "An object describing a single error.", 
            "properties": {
              "field": {
                "type": "string", 
                "description": "The field with the error if applicable."
              }, 
              "message": {
                "type": "string", 
                "description": "The error message."
              }, 
              "code": {
                "type": "string", 
                "description": "The error code."
              }
            }
          }, 
          "type": "array"
        }
      }
    }, 
    {
      "additionalProperties": false, 
      "type": "object", 
      "properties": {
        "nodes": {
          "minItems": 0, 
          "items": {
            "type": "object", 
            "description": "An object containing a node's drive subsystem XML configuration file.", 
            "properties": {
              "stall": {
                "type": "object", 
                "description": "Configuration settings to evaluate a drive stall.", 
                "properties": {
                  "max_total_stall_time": {
                    "default": 10800, 
                    "type": "integer", 
                    "description": "The maximum amount of time, in seconds, to remain stalled before softfailing the drive.", 
                    "maximum": 4294967295
                  }, 
                  "max_slow_frequency": {
                    "default": 0, 
                    "type": "integer", 
                    "description": "The number of slow frequency triggers during stalled drive disk exercises to cause the drive to be softfailed.", 
                    "maximum": 4294967295
                  }, 
                  "max_error_frequency": {
                    "default": 0, 
                    "type": "integer", 
                    "description": "The number of errors during stalled drive disk exercises to cause the drive to be softfailed.", 
                    "maximum": 4294967295
                  }, 
                  "diskscrub_stripes": {
                    "default": 128, 
                    "type": "integer", 
                    "description": "Number of stripes to read during a diskscrub.", 
                    "maximum": 4294967295
                  }, 
                  "clear_time": {
                    "default": 2592000, 
                    "type": "integer", 
                    "description": "The amount of time in seconds with no stalls before ignoring previous stalls.", 
                    "maximum": 4294967295
                  }, 
                  "scan_size": {
                    "default": 16777216, 
                    "type": "integer", 
                    "description": "Total bytes of error-free reads to complete a scan.", 
                    "maximum": 4294967295
                  }, 
                  "scan_max_ecc_delay": {
                    "default": 60, 
                    "type": "integer", 
                    "description": "Maximum delay in seconds after an ECC correction during a scan.", 
                    "maximum": 4294967295
                  }, 
                  "sleep": {
                    "default": "30", 
                    "type": "integer", 
                    "description": "Delay in seconds between evaluations.", 
                    "maximum": 4294967295
                  }, 
                  "max_slow_access": {
                    "default": 0, 
                    "type": "integer", 
                    "description": "The number of slow accesses during stalled drive disk exercises to cause the drive to be softfailed.", 
                    "maximum": 4294967295
                  }
                }
              }, 
              "log": {
                "type": "object", 
                "description": "Configuration settings for drive statistics logs.", 
                "properties": {
                  "drive_stats": {
                    "default": "true", 
                    "type": "boolean", 
                    "description": "Indicates whether or not to log the drive statistics."
                  }
                }
              }, 
              "reboot": {
                "type": "object", 
                "description": "Configuration settings for a node reboot due to a drive error.", 
                "properties": {
                  "none_present": {
                    "default": true, 
                    "type": "boolean", 
                    "description": "Indicates whether or not to reboot the node if no drives are present."
                  }, 
                  "chassis_loss": {
                    "default": true, 
                    "type": "boolean", 
                    "description": "Indicates whether or not to reboot the node due to a lost chassis."
                  }
                }
              }, 
              "automatic_replacement_recognition": {
                "type": "object", 
                "description": "Configuration settings for automatic replacement recognition (ARR).", 
                "properties": {
                  "enabled": {
                    "default": "true", 
                    "type": "boolean", 
                    "description": "Enable automatic replacement recognition (ARR)."
                  }
                }
              }, 
              "lnn": {
                "type": "integer", 
                "description": "Logical Node Number (LNN) of this node."
              }, 
              "allow": {
                "type": "object", 
                "description": "Configuration settings for drive formatting.", 
                "properties": {
                  "format_unknown_firmware": {
                    "default": "true", 
                    "type": "boolean", 
                    "description": "Allow formatting a drive model with unknown firmware."
                  }, 
                  "format_unknown_model": {
                    "default": "true", 
                    "type": "boolean", 
                    "description": "Allow formatting an unknown drive model."
                  }
                }
              }, 
              "spin_wait": {
                "type": "object", 
                "description": "Configuration settings for sleeping the drive daemon before node is rescanned.", 
                "properties": {
                  "stagger": {
                    "default": 5, 
                    "type": "integer", 
                    "description": "Seconds to wait between enabling a bay and enabling another bay.", 
                    "maximum": 4294967295
                  }, 
                  "check_drive": {
                    "default": 45, 
                    "type": "integer", 
                    "description": "Seconds to wait between enabling a bay and checking for an inserted drive.", 
                    "maximum": 4294967295
                  }
                }
              }, 
              "alert": {
                "type": "object", 
                "description": "Configuration setting for drive alerts.", 
                "properties": {
                  "unknown_model": {
                    "default": "true", 
                    "type": "boolean", 
                    "description": "Send alerts for unknown drive model."
                  }, 
                  "unknown_firmware": {
                    "default": "true", 
                    "type": "boolean", 
                    "description": "Send alerts for unknown drive firmware."
                  }
                }
              }, 
              "id": {
                "type": "integer", 
                "description": "Node ID (Device Number) of this node."
              }
            }
          }, 
          "type": "array", 
          "maxItems": 4294967295
        }, 
        "total": {
          "minimum": 0, 
          "type": "integer", 
          "description": "Total number of items available.", 
          "maximum": 4294967295
        }
      }
    }
  ]
}

********************************************************************************

Method PUT: Modify a node's drive subsystem XML configuration file.

       URL: PUT /platform/<<version=5>>/cluster/nodes/<LNN>/driveconfig

There are no query arguments for this method.

PUT request body schema:
{
  "type": "object", 
  "description": "An object containing a node's drive subsystem XML configuration file.", 
  "properties": {
    "automatic_replacement_recognition": {
      "type": "object", 
      "description": "Configuration settings for automatic replacement recognition (ARR).", 
      "properties": {
        "enabled": {
          "default": "true", 
          "type": "boolean", 
          "description": "Enable automatic replacement recognition (ARR)."
        }
      }
    }
  }
}

There is no JSON response body for this method.
